home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / mint / mintmant / fputchar.txt < prev    next >
Text File  |  1992-03-24  |  2KB  |  64 lines
  1. Fputchar(2)               Oct. 1, 1991                Fputchar(2)
  2.  
  3.  
  4.  
  5. NAME
  6.      Fputchar - read a character from a file
  7.  
  8. SYNOPSIS
  9.      LONG Fputchar( WORD fh, LONG ch, WORD mode );
  10.  
  11. DESCRIPTION
  12.      Fputchar outputs a character to the GEMDOS file whose handle
  13.      is  fh.   The  parameter mode has an effect only if the open
  14.      file is a terminal or pseudo-terminal,  in  which  case  the
  15.      bits of mode have the following meanings:
  16.  
  17.      0x0001
  18.           Cooked mode; special control characters (control-C  and
  19.           control-Z)  are  checked  for  and interpreted if found
  20.           (they cause SIGINT and  SIGTSTP,  respectively,  to  be
  21.           raised);   also,   flow   control  with  control-S  and
  22.           control-Q is activated.
  23.  
  24.      If the file receiving output is a pseudo-terminal, then  all
  25.      4  bytes  of  ch  are  recorded  in  the  write,  and may be
  26.      retreived by a Fputchar  call  on  the  other  side  of  the
  27.      pseudo-terminal; this allows programs to pass simulated BIOS
  28.      scan codes and shift key status through the pseudo-terminal.
  29.  
  30.      If the file receiving output is not a  terminal,  then  only
  31.      the low order byte of ch is written to the file.
  32.  
  33. RETURNS
  34.      4 (the number of bytes of data transferred) if the write was
  35.      to a terminal
  36.  
  37.      1 if the write was not to a terminal and was successful
  38.  
  39.      0 if the bytes could not be output (for example, because  of
  40.      flow control)
  41.  
  42.      EIHNDL if fh is not a valid handle for an open file.
  43.  
  44.      A (long) negative BIOS error code if an error occured during
  45.      physical I/O.
  46.  
  47. SEE ALSO
  48.      Bconout(2), Cauxout(2), Cconout(2), Crawio(2),  Fgetchar(2),
  49.      Fwrite(2)
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60. Version 0.9   Last change: MiNT Programmer's Manual             1
  61.  
  62.  
  63.  
  64.